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RENUM is a RAM-based machine-language program that 
renumbers the lines in any LEVEL II BASIC program. The 
minimum equipment required to load and use RENUM 
consists of the following: LEVEL 1 1 TRS-80 CPU/ 
Keyboard (4K or more); Video Display; and a cassette 
recorder such as the CTR-41. 

Typical uses of RENUM: 

* Expanding or compressing line number ranges to make 
room for additional program lines. 

* "Cleaning up" your finished program by 
converting to uniform line-number increments. 

* Adapting existing subroutine line numbers to suit the 
particular program you plan to type in. 



Note to TRSDOS Users: 

To use RENUM, you must ca ll up LEV EL II BASIC (in the 
DOS mode, type:BASIC2 l«ina ). You may then follow 
the instructions in this booklet. 



How to Load RENUM 

You must first reserve memory for the machine-language 
program (so your BASIC program won't write over it 
during execution). To reserve memory, power-on the 
TRS-80 and answer the memory size question as follows: 

If your TRS-80 has . . . MEMORY SIZE should be 

4K 19531 

16K 31819 

32K 48203 

48K 64587 

Note: The RENUM cassette package contains four pro- 
grams - one for each TRS-80 memory size. Locate the 
appropriately labeled cassette, insert it into the recorder, 
and prepare the recorder to play the program. 

To load RENUM from the cassette, type SYSTEM BBH1B 
followed by the file name RENUM I ggfjgfl 

When the program has loaded, a second*?will appear. (If 
the load is unsuccessful, a C will appear in the upper right 
of the Display. Check the recorder's volume setting and 
reload the program.) After loading the program success- 
fully, press the 1:1^*.1I4 key to return to BASIC. 

You can now call the RENUM program at any time, by 
typing SYSTEMjjjJjj^followed by a / and the entry- 
point. Determine the correct entry-point by adding 1 to the 
number you entered for MEMORY SIZE. For example, 
the entry-point for the 16K machine is 3 1820. 



How to Use R EN UM 

RENUM lets you specify the first line number to be renum- 
bered, the new line number for that line, and the incre- 
ment to be used between all subsequent lines. You cannot 
renumber a block of lines in the middle of the program; 
beginning with the line number you choose, all subsequent 
lines will be renumbered. 

Let's assume you have entered your BASIC program and 
you wish to renumber it. First determine the lowest line 
number you wish to change (referred to as OL#); the new 
line number you wish to assign to that line (referred to as 
NL#); and the increment to be used between all subsequent 
lines of your program (referred to as INC). 

Call RENUM a s describe d above (by typing SYSTEM I3J13J 

/ entrv-Doint \l?ill;\ ). The program will prompt you to 
enter OL#, NL#, and INC, one at a time . Simply type in 
the desired parameters and pressEZffiQ after each one. If 
you pressEHEQwithout first typing in a number, RENUM 
will assign a default value to that particular parameter: 

Parameter Default Value 

OL#=Q2ii3D (entire program will 

be renumbered) 

NL*° EgH|3 10 

INC= Wiii\\ 10 



NOTE: To help you avoid mistakes, RENUM will only 

accept entries fro m the foll owing keys: the digits 
0-9, back space <*-,QEHJ3 and BREAK . Hitting 
[3332Qduring entry of the three parameters restarts 
the RENUM program. Furthermore, if the OL# 
you enter is not used in your program, renumbering 
will begin with the first line number greater than 
OL#. If there are no line numbers greater than 
or equal to OL#, an error will occur. 

After you enter the last item, INC, RENUM will proceed to 
renumber your BASIC program. When the renumbering is 
completed, RENUM will return you to BASIC with a 
READY message. 

The renumbered program will be ready to run as is. Not 
only the program line numbers, but also the line number 
references in your program text, will be renumbered 
correctly. That is, line numbers appearing in GOTO, 
GOSUB, THEN, ELSE, ON n GOTO, ON n GOSUB, ON 
ERROR GOTO, RESUME and ERL relational operator 
expressions will be properly changed to reference the new 
line numbers. ON ERROR GOTO and RESUME are 
special cases; the zeros in these expressions are not changed. 
(The numbers have a special meaning in these statements 
and should not be changed. See LEVEL II Reference 
Manual, Chapter 4.) 



Sample Runs 

First load the RENUM program and enter the following 
BASIC program. 



10 


GOTO 


30 


18 


END 




27 


GOTO 


18 


321 


GOTO 


27 



Now call RE NUM (b y typing SYSTEM l^bdJ;! 

entry point I3JJI3;! , and enter the following values. 

OL# = 1=^113:1 
nl# = ».'Ma;i 

inc =nznia 

The renumbered program will look like this: 

10 GOTO 40 

20 END 

30 GOTO 20 

40 GOTO 30 

Using the original program, enter the following values. 

OL# = 18 
NL# = 12 
INC = 2 



The renumbered program will look like this: 

10 GOTO 16 

12 END 

14 GOTO 12 

16 GOTO 14 



Error Messages 

Two error messages may be generated during execution of 
RENUM: ILLEGAL FC (Illegal Function Call) and UL 
line-number IN line-number. ILLEGAL FC occurs when: 

1 ) You try to create line numbers greater than 65529 

2) You enter an INC of zero 

3) The value of OL# is larger than the largest line 
number used in your program. 

4) You attempt to change the sequence of program 
lines. For example, using the original program 
above (lines 10, 18, 27 and 30), if you entered 
OL#=18 and NL#=5, the effect would be to cause 
line 18 to precede line 10. This would result in an 
ILLEGAL FC error. When an ILLEGAL FC error 
occurs, RENUM returns you to BASIC and your 
original program is unaffected. 

UL line-number IN line-number occurs when your original 
program references a non-existent line number (for 
example, a GOTO 100 when there is no line 100 in the 
original program). In such a case, RENUM will not renumber 
the undefined line reference, but will renumber the rest 
of the program. The error message is just a warning to you 
that the original program contained an undefined line- 
number reference which could not be renumbered. 

For example, consider the program: 



100 INPUT X 

110 IF X>10 GOTO 1000 

120 PRINT X*3 .14159 

If you renumber the program with OL#=100, NL#=1000, 
and INC=10, the resulting program will be: 

1000 INPUT X 

1010 IF X>10 GOTO 1000 

1020 PRINT X*3. 14159 

and an error message, UL 1000 IN 10*0 , will be 
displayed (even though, in this case, renumbering "correct- 
ed" the undefined line reference). 

If the undefined line reference inside the program is greater 
than 65529, it is not displayed in the error message; instead, 
UL IN line-number will be displayed. 

NOTE: Using RENUM to renumber your program may 
increase or decrease the size of your program, depending 
on the values you enter for OL#, NL# and INC. This is 
because line references in the program text are stored in 
ASCII form, one byte per digit. Therefore a three-digit 
number will take up more room in the program text than 
will a two-digit number. 

So if you plan to make your line numbers larger using the 
RENUM program, be sure thatyou have enough memory 
available to hold the expanded text. Otherwise your program 
might be lost. 
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All Radio Shack computer programs are distributed on an "AS IS' 
basis without warranty- 
Radio Shack shall have no liability or responsibility to customer or 
any other person or entity with respect to any liability, loss or dam- 
age caused or alleged to be caused directly or indirectly by computer 
equipment or programs sold by Radio Shack, including but not lim- 
ited to any interruption of service, loss of business or anticipatory 
profits or consequential damages resulting from the use or operation 
of such computer or computer programs. 

NOTE: Good data processing procedure dictates that the user test 
the program, run and test sample sets of data, and run the 
system in parallel with the system previously in use for a 
period of time adequate to insure that results of operation 
of the computer or program are satisfactory. 

Refer to User's Manual for warranties. Failure to adhere to proce- 
dures set forth in User's Manual may result in the loss of warranties. 
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